Skip to content

fix: make StepRegistry atomic and raise on corruption - #3922

Open
Quratulain-bilal wants to merge 1 commit into
github:mainfrom
Quratulain-bilal:fix/step-registry-atomic-save
Open

fix: make StepRegistry atomic and raise on corruption#3922
Quratulain-bilal wants to merge 1 commit into
github:mainfrom
Quratulain-bilal:fix/step-registry-atomic-save

Conversation

@Quratulain-bilal

Copy link
Copy Markdown
Contributor

Problem

StepRegistry._load() silently returned empty defaults on corruption, causing installed steps to appear to vanish. save() wrote directly to the target file risking data loss.

Fix

_load() now raises OSError on symlinked paths and corrupted files. save() now uses atomic writes via mkstemp + os.replace.

…nt data loss

1. _load() now raises OSError on symlinked paths and corrupted files
   instead of silently returning empty defaults (matches WorkflowRegistry)
2. save() now writes to a temp file and atomically replaces, preventing
   data loss from truncated writes on crash

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Makes StepRegistry fail closed on corruption and persist data atomically.

Changes:

  • Raises OSError for unsafe or corrupted registries.
  • Writes through a temporary file using os.replace.
  • Cleans up temporary files after failures.
Show a summary per file
File Description
src/specify_cli/workflows/catalog.py Hardens registry loading and saving.

Review details

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

  • Files reviewed: 1/1 changed files
  • Comments generated: 3
  • Review effort level: Balanced

Comment on lines +901 to +908
except (
json.JSONDecodeError,
ValueError,
UnicodeError,
) as exc:
raise OSError(
f"Step registry at {self.registry_path} is corrupted: {exc}"
) from exc
Comment on lines +942 to +944
with os.fdopen(fd, "w", encoding="utf-8") as f:
json.dump(self.data, f, indent=2)
os.replace(tmp, self.registry_path)
Comment on lines +889 to +892
raise OSError(
f"Refusing to read step registry at {self.registry_path}: "
"a parent directory or the registry file itself is a symlink"
)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants